Skip to main content

Message Node

The Message node is one of the core building blocks in a chatflow. It enables you to send structured content—such as text, images, videos, cards, or quick replies—to your users. You can drive text generation with an LLM (e.g. gpt-4) and interpolate context variables to create highly dynamic, personalized messages.

Configuration Options​

1. Model​

  • Description: Determines which language model is used to generate text.
  • Examples: gpt-4, gpt-3.5-turbo
  • Best practice: Use gpt-4 for long-form or creative messages; gpt-3.5-turbo for short, predictable responses.

2. Instruction​

  • Description: A system-level prompt that sets the tone, style, or rules before user context is applied.
  • Syntax: Plain text or markdown.
  • Example: 
    You are a helpful assistant. Keep messages under 100 words and include a friendly greeting.```

3. Type​

Defines the payload format for the node. Changing this updates the editor fields below.

OptionWhen to use
TextSending plain or LLM-generated copy
ImageDisplaying pictures, diagrams, or GIFs
VideoEmbedding short clips or demos
Basic CardRich content card with title, image, and buttons
Quick replyPresenting a set of selectable options

3a. Text Editor​

  • Field: Text

  • Capabilities:

    • Supports markdown formatting
    • Variable interpolation with {{variableName}}
    • LLM completion when you include an instruction-style prompt in the box

  • Common variables:

    {{id}}        // Unique identifier (e.g. order #)
    {{Name}}      // User’s display name
    {{key}}       // Custom data from earlier nodes
“Image Properties” panel
Hello {{Name}}! Your order #{{id}} is confirmed. We'll email you when it's shipped.

3b. Image Properties​

When you select Image as the Type, you’ll see:

  • Text: (LLM or static copy, same as the Text editor above)

  • Image Properties (expandable panel):

    • Title — Label for this image block (required)
    • Image URL — Direct link to the JPEG/PNG/GIF to display
“Image Properties” panel
▾ Image Properties
  * Title     [______________]  ← “Enter the title”
  * Image URL [______________]  ← “Enter Image URL”

3c. Video Properties​

When you select Video, you’ll see:

  • Text: (as above)

  • Video Properties (expandable panel):

    • Title — Headline for the video
    • Subtitle — Short descriptor
    • Image — Thumbnail URL (PNG/JPG)
    • Media — Direct link to MP4/WebM file
    • Description — Text to show below the video
“Video Properties” panel
▾ Video Properties
  Title       [______________]
  Subtitle    [______________]
  Image       [______________]
  Media       [______________]  ← “Enter video URL”
  Description [______________]

3d. Basic Card Properties​

When you select Basic Card, you’ll see:

  • Text: (as above)

  • Basic Card Properties (expandable panel):

    • Title — Card headline
    • Subtitle — Secondary text
    • Image — Thumbnail or feature graphic URL
    • Description — Body text
    • Buttons — (if supported) up to 3 CTAs, each with a label and payload
“Basic Card Properties” panel
▾ Basic Card Properties
  Title       [______________]
  Subtitle    [______________]
  Image       [______________]
  Description [______________]
  (Buttons…)

3e. Quick Reply Properties​

When you select Quick reply, you’ll see:

  • Text: (as above)

  • Quick Replies Properties (expandable panel):

    • Title — Prompt above the reply buttons
    • Text — Body text for context

  • Quick Replies — A list of individual replies, each defined by:

    • Label — What the user sees
    • Value — Payload sent when clicked
“Quick replies Properties” panel
▾ Quick Replies Properties
  Title [______________]  ← “Enter the title”
  Text  [______________]  ← “Enter the text”
  [ Save ]

Quick Replies:
  • [Yes]  → payload "yes"
  • [No]   → payload "no"

Tips​

  • Keep instructions concise to avoid confusing the model.
  • Preview your flow often to verify variable interpolation.
  • Test different models and compare outputs for tone and accuracy.
  • Provide fallback content: Have a static message or quick-reply backup if the LLM call fails.
  • Chain nodes: Compute variables upstream and reference them here for end-to-end dynamic conversations.

Note: Switching the Type will replace the editor panel below. Your existing text won’t be lost, but you will need to re-enter it in the new format.